Node / meshtastic / Meshtastic-Android / files / feature / car / src / main / kotlin / org / meshtastic / feature / car / util / CarScreenDataBuilder.kt

Displaying Raw • Download

T8b949e/*

* Copyright (c) 2026 Meshtastic LLC

*

* This program is free software: you can redistribute it and/or modify

* it under the terms of the GNU General Public License as published by

* the Free Software Foundation, either version 3 of the License, or

* (at your option) any later version.

*

* This program is distributed in the hope that it will be useful,

* but WITHOUT ANY WARRANTY; without even the implied warranty of

* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the

* GNU General Public License for more details.

*

* You should have received a copy of the GNU General Public License

* along with this program. If not, see <https://www.gnu.org/licenses/>.

*/

Tff7b72package T7ee787org.meshtastic.feature.car.util

Tff7b72import T7ee787org.meshtastic.core.model.Node

Tff7b72import T7ee787org.meshtastic.core.model.NodeAddress

Tff7b72import T7ee787org.meshtastic.core.model.snrLimit

Tff7b72import T7ee787org.meshtastic.feature.car.model.CarLocalStats

Tff7b72import T7ee787org.meshtastic.feature.car.model.ConversationUi

Tff7b72import T7ee787org.meshtastic.feature.car.model.NodeUi

Tff7b72import T7ee787org.meshtastic.feature.car.model.SignalQuality

Tff7b72import T7ee787org.meshtastic.feature.car.service.MessageSnapshot

Tff7b72import T7ee787org.meshtastic.proto.Config.LoRaConfig.ModemPreset

Tff7b72import T7ee787org.meshtastic.proto.LocalStats

T8b949e/**

* Pure-function helpers that convert domain models into car UI models.

*

* All methods are free of Car App Library dependencies, making them testable as plain JVM unit tests without

* Robolectric.

*/

Tff7b72internal Tff7b72object T56d364CarScreenDataBuilder Tb4b4b4{

Tff7b72private Tff7b72const Tff7b72val Te6edf3SECONDS_TO_MILLIS Tff7b72= T79c0ff1T79c0ff0T79c0ff0T79c0ff0L

Tff7b72private Tff7b72const Tff7b72val Te6edf3MINUTE_SECONDS Tff7b72= T79c0ff6T79c0ff0

Tff7b72private Tff7b72const Tff7b72val Te6edf3HOUR_SECONDS Tff7b72= T79c0ff3T79c0ff6T79c0ff0T79c0ff0

Tff7b72private Tff7b72const Tff7b72val Te6edf3DAY_SECONDS Tff7b72= T79c0ff8T79c0ff6T79c0ff4T79c0ff0T79c0ff0

Tff7b72private Tff7b72const Tff7b72val Te6edf3BATTERY_MAX_PERCENT Tff7b72= T79c0ff1T79c0ff0T79c0ff0

T8b949e// Preset-relative SNR band offsets (dB) around the modem preset's demodulation floor; aligned with core/ui

T8b949e// LoraSignalIndicator. EXCELLENT sits a margin above the floor; FAIR/BAD step below it.

Tff7b72private Tff7b72const Tff7b72val Te6edf3SNR_EXCELLENT_MARGIN Tff7b72= T79c0ff5.5f

Tff7b72private Tff7b72const Tff7b72val Te6edf3SNR_FAIR_OFFSET Tff7b72= T79c0ff5.5f

Tff7b72private Tff7b72const Tff7b72val Te6edf3SNR_BAD_OFFSET Tff7b72= T79c0ff7.5f

T8b949e/** Converts a [Node] to a [NodeUi] for car display. */

Tff7b72fun Td2a8ffbuildNodeUiTb4b4b4(Te6edf3nodeTb4b4b4: Te6edf3NodeTb4b4b4, Te6edf3modemPresetTb4b4b4: Te6edf3ModemPreset? Tff7b72= Tff7b72nullTb4b4b4)Tb4b4b4: Te6edf3NodeUi Tff7b72= Te6edf3NodeUiTb4b4b4(

Te6edf3nodeNum Tff7b72= Te6edf3nodeTb4b4b4.Te6edf3numTb4b4b4,

Te6edf3userId Tff7b72= Te6edf3nodeTb4b4b4.Te6edf3userTb4b4b4.Te6edf3idTb4b4b4,

Te6edf3longName Tff7b72= Te6edf3nodeTb4b4b4.Te6edf3userTb4b4b4.Te6edf3long_nameTb4b4b4.Te6edf3ifEmpty Tb4b4b4{ Ta5d6ff"Ta5d6ffUnknownTa5d6ff" Tb4b4b4}Tb4b4b4,

Te6edf3shortName Tff7b72= Te6edf3nodeTb4b4b4.Te6edf3userTb4b4b4.Te6edf3short_nameTb4b4b4.Te6edf3ifEmpty Tb4b4b4{ Ta5d6ff"Ta5d6ff?Ta5d6ff" Tb4b4b4}Tb4b4b4,

Te6edf3signalQuality Tff7b72= Te6edf3determineSignalQualityTb4b4b4(Te6edf3nodeTb4b4b4.Te6edf3snrOrNullTb4b4b4, Te6edf3modemPresetTb4b4b4)Tb4b4b4,

Te6edf3batteryPercent Tff7b72= Te6edf3nodeTb4b4b4.Te6edf3batteryLevelTff7b72?.Te6edf3takeIf Tb4b4b4{ Tffa657it Tff7b72in T79c0ff1.Tb4b4b4.Te6edf3BATTERY_MAX_PERCENT Tb4b4b4}Tb4b4b4,

Te6edf3isOnline Tff7b72= Te6edf3nodeTb4b4b4.Te6edf3isOnlineTb4b4b4,

Te6edf3lastHeard Tff7b72= Te6edf3nodeTb4b4b4.Te6edf3lastHeardTb4b4b4.Te6edf3toLongTb4b4b4(Tb4b4b4) Tff7b72* Te6edf3SECONDS_TO_MILLISTb4b4b4,

Te6edf3hasPosition Tff7b72= Te6edf3nodeTb4b4b4.Te6edf3validPosition Tff7b72!Tff7b72= Tff7b72nullTb4b4b4,

Tb4b4b4)

T8b949e/** Sorts nodes for car display: online nodes first, then by lastHeard descending. */

Tff7b72fun Td2a8ffsortNodesTb4b4b4(Te6edf3nodesTb4b4b4: Te6edf3CollectionTff7b72<Te6edf3NodeTff7b72>Tb4b4b4, Te6edf3modemPresetTb4b4b4: Te6edf3ModemPreset? Tff7b72= Tff7b72nullTb4b4b4)Tb4b4b4: Te6edf3ListTff7b72<Te6edf3NodeUiTff7b72> Tff7b72= Te6edf3nodes

Tb4b4b4.Te6edf3map Tb4b4b4{ Te6edf3buildNodeUiTb4b4b4(Tffa657itTb4b4b4, Te6edf3modemPresetTb4b4b4) Tb4b4b4}

Tb4b4b4.Te6edf3sortedWithTb4b4b4(Te6edf3compareByDescendingTff7b72<Te6edf3NodeUiTff7b72> Tb4b4b4{ Tffa657itTb4b4b4.Te6edf3isOnline Tb4b4b4}Tb4b4b4.Te6edf3thenByDescending Tb4b4b4{ Tffa657itTb4b4b4.Te6edf3lastHeard Tb4b4b4}Tb4b4b4)

T8b949e/** Builds ordered conversation list: sorted by most recent message time descending. */

Tff7b72fun Td2a8ffsortConversationsTb4b4b4(Te6edf3conversationsTb4b4b4: Te6edf3ListTff7b72<Te6edf3ConversationUiTff7b72>Tb4b4b4)Tb4b4b4: Te6edf3ListTff7b72<Te6edf3ConversationUiTff7b72> Tff7b72=

Te6edf3conversationsTb4b4b4.Te6edf3sortedByDescending Tb4b4b4{ Tffa657itTb4b4b4.Te6edf3lastMessageTime Tb4b4b4}

T8b949e/**

* Determines signal quality from SNR relative to the modem preset's demodulation floor ([ModemPreset.snrLimit]).

* RSSI is not used (matching core/ui); a null/unknown preset falls back to the LongFast default limit.

*

* A null [snr] means no reading and yields [SignalQuality.UNKNOWN], never [SignalQuality.NONE] — the latter claims

* a measured, undemodulable link. 0 dB is a real reading and rates normally.

*/

Tff7b72fun Td2a8ffdetermineSignalQualityTb4b4b4(Te6edf3snrTb4b4b4: Tffa657Float?Tb4b4b4, Te6edf3modemPresetTb4b4b4: Te6edf3ModemPreset? Tff7b72= Tff7b72nullTb4b4b4)Tb4b4b4: Te6edf3SignalQuality Tb4b4b4{

Tff7b72if Tb4b4b4(Te6edf3snr Tff7b72=Tff7b72= Tff7b72nullTb4b4b4) Tff7b72return Te6edf3SignalQualityTb4b4b4.Te6edf3UNKNOWN

Tff7b72val Te6edf3limit Tff7b72= Te6edf3modemPresetTb4b4b4.Te6edf3snrLimit

Tff7b72return Tff7b72when Tb4b4b4{

Te6edf3snr Tff7b72> Te6edf3limit Tff7b72+ Te6edf3SNR_EXCELLENT_MARGIN Tff7b72-Tff7b72> Te6edf3SignalQualityTb4b4b4.Te6edf3EXCELLENT

Te6edf3snr Tff7b72> Te6edf3limit Tff7b72-Tff7b72> Te6edf3SignalQualityTb4b4b4.Te6edf3GOOD

Te6edf3snr Tff7b72> Te6edf3limit Tff7b72- Te6edf3SNR_FAIR_OFFSET Tff7b72-Tff7b72> Te6edf3SignalQualityTb4b4b4.Te6edf3FAIR

Te6edf3snr Tff7b72>Tff7b72= Te6edf3limit Tff7b72- Te6edf3SNR_BAD_OFFSET Tff7b72-Tff7b72> Te6edf3SignalQualityTb4b4b4.Te6edf3BAD

Tff7b72else Tff7b72-Tff7b72> Te6edf3SignalQualityTb4b4b4.Te6edf3NONE

Tb4b4b4}

Tb4b4b4}

T8b949e/**

* Builds a [CarLocalStats] snapshot from the device's [Node], [LocalStats], and node DB. Falls back to

* Node.deviceMetrics when LocalStats hasn't been populated yet.

*/

Tf0883e@SuppressTb4b4b4(Ta5d6ff"Ta5d6ffMagicNumberTa5d6ff"Tb4b4b4)

Tff7b72fun Td2a8ffbuildLocalStatsTb4b4b4(Te6edf3ourNodeTb4b4b4: Te6edf3Node?Tb4b4b4, Te6edf3statsTb4b4b4: Te6edf3LocalStatsTb4b4b4, Te6edf3allNodesTb4b4b4: Te6edf3CollectionTff7b72<Te6edf3NodeTff7b72>Tb4b4b4)Tb4b4b4: Te6edf3CarLocalStats Tb4b4b4{

Tff7b72val Te6edf3metrics Tff7b72= Te6edf3ourNodeTff7b72?.Te6edf3deviceMetrics

Tff7b72val Te6edf3hasStats Tff7b72= Te6edf3statsTb4b4b4.Te6edf3uptime_seconds Tff7b72!Tff7b72= T79c0ff0

Tff7b72return Te6edf3CarLocalStatsTb4b4b4(

Te6edf3batteryLevel Tff7b72= Te6edf3metricsTff7b72?.Te6edf3battery_level Tff7b72?: T79c0ff0Tb4b4b4,

Te6edf3hasBattery Tff7b72= Te6edf3metricsTff7b72?.Te6edf3battery_level Tff7b72!Tff7b72= Tff7b72nullTb4b4b4,

Te6edf3channelUtilization Tff7b72= Tff7b72if Tb4b4b4(Te6edf3hasStatsTb4b4b4) Te6edf3statsTb4b4b4.Te6edf3channel_utilization Tff7b72else Te6edf3metricsTff7b72?.Te6edf3channel_utilization Tff7b72?: T79c0ff0fTb4b4b4,

Te6edf3airUtilization Tff7b72= Tff7b72if Tb4b4b4(Te6edf3hasStatsTb4b4b4) Te6edf3statsTb4b4b4.Te6edf3air_util_tx Tff7b72else Te6edf3metricsTff7b72?.Te6edf3air_util_tx Tff7b72?: T79c0ff0fTb4b4b4,

Te6edf3totalNodes Tff7b72= Te6edf3allNodesTb4b4b4.Te6edf3sizeTb4b4b4,

Te6edf3onlineNodes Tff7b72= Te6edf3allNodesTb4b4b4.Te6edf3count Tb4b4b4{ Tffa657itTb4b4b4.Te6edf3isOnline Tb4b4b4}Tb4b4b4,

Te6edf3uptimeSeconds Tff7b72= Tff7b72if Tb4b4b4(Te6edf3hasStatsTb4b4b4) Te6edf3statsTb4b4b4.Te6edf3uptime_seconds Tff7b72else Te6edf3metricsTff7b72?.Te6edf3uptime_seconds Tff7b72?: T79c0ff0Tb4b4b4,

Te6edf3numPacketsTx Tff7b72= Te6edf3statsTb4b4b4.Te6edf3num_packets_txTb4b4b4,

Te6edf3numPacketsRx Tff7b72= Te6edf3statsTb4b4b4.Te6edf3num_packets_rxTb4b4b4,

Tb4b4b4)

Tb4b4b4}

T8b949e/** Formats uptime seconds as a human-readable string. */

Tff7b72fun Td2a8ffformatUptimeTb4b4b4(Te6edf3secondsTb4b4b4: Tffa657IntTb4b4b4)Tb4b4b4: Tffa657String Tb4b4b4{

Tff7b72val Te6edf3days Tff7b72= Te6edf3seconds Tff7b72/ Te6edf3DAY_SECONDS

Tff7b72val Te6edf3hours Tff7b72= Tb4b4b4(Te6edf3seconds Tff7b72% Te6edf3DAY_SECONDSTb4b4b4) Tff7b72/ Te6edf3HOUR_SECONDS

Tff7b72val Te6edf3minutes Tff7b72= Tb4b4b4(Te6edf3seconds Tff7b72% Te6edf3HOUR_SECONDSTb4b4b4) Tff7b72/ Te6edf3MINUTE_SECONDS

Tff7b72return Tff7b72when Tb4b4b4{

Te6edf3days Tff7b72> T79c0ff0 Tff7b72-Tff7b72> Ta5d6ff"Tffd700${Te6edf3daysTffd700}Ta5d6ffd Tffd700${Te6edf3hoursTffd700}Ta5d6ffhTa5d6ff"

Te6edf3hours Tff7b72> T79c0ff0 Tff7b72-Tff7b72> Ta5d6ff"Tffd700${Te6edf3hoursTffd700}Ta5d6ffh Tffd700${Te6edf3minutesTffd700}Ta5d6ffmTa5d6ff"

Tff7b72else Tff7b72-Tff7b72> Ta5d6ff"Tffd700${Te6edf3minutesTffd700}Ta5d6ffmTa5d6ff"

Tb4b4b4}

Tb4b4b4}

T8b949e/**

* Returns the contact key in the format expected by the messaging system. Channels use `"<channelIndex>^all"`

* format; DMs use `"0<nodeId>"`.

*/

Tff7b72fun Td2a8ffbuildContactKeyTb4b4b4(Te6edf3channelIndexTb4b4b4: Tffa657IntTb4b4b4)Tb4b4b4: Tffa657String Tff7b72= Ta5d6ff"Tffd700${Te6edf3channelIndexTffd700}Tffd700${Te6edf3NodeAddressTb4b4b4.Te6edf3ID_BROADCASTTffd700}Ta5d6ff"

T8b949e/** Returns the most recent N messages from a list, ordered chronologically (oldest first). */

Tff7b72fun Td2a8ffrecentMessagesTb4b4b4(Te6edf3messagesTb4b4b4: Te6edf3ListTff7b72<Te6edf3MessageSnapshotTff7b72>Tb4b4b4, Te6edf3limitTb4b4b4: Tffa657Int Tff7b72= Te6edf3MAX_CONVERSATION_MESSAGESTb4b4b4)Tb4b4b4: Te6edf3ListTff7b72<Te6edf3MessageSnapshotTff7b72> Tff7b72=

Te6edf3messagesTb4b4b4.Te6edf3takeLastTb4b4b4(Te6edf3limitTb4b4b4)

T8b949e/** Maximum messages to include in a ConversationItem. */

Tff7b72const Tff7b72val Te6edf3MAX_CONVERSATION_MESSAGES Tff7b72= T79c0ff5

T8b949e/** Maximum conversations to display in the messaging list. */

Tff7b72const Tff7b72val Te6edf3MAX_CONVERSATIONS Tff7b72= T79c0ff1T79c0ff0

Tb4b4b4}